home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / dirmgmt / checkl.arc / DC.DOC < prev    next >
Text File  |  1988-04-06  |  8KB  |  178 lines
  1.                  DC - Directory Control
  2.                       Version 1.03d
  3.                     by Peter Esherick
  4.  
  5.            Contact via: Albuquerque PC Users' Group or
  6.            Albuquerque RBBS, 296-7672, John Maio, sysop
  7.            Midnight Express  836-9576, Terry Stein, sysop
  8.            Surya             294-9601, Paramjeet Singh, sysop
  9.  
  10.  
  11. Command DC
  12. ----------
  13.  
  14. Purpose:  To allow selective copying, moving, deleting and browsing
  15.           of files displayed in a directory listing.
  16.  
  17. Format:   DC [d:][source-path] [d:][dest-path] [/O,N,E,D,or S][/F]
  18.  
  19. Remarks:  
  20.    This program is closely based on the CO and DR programs, both written 
  21. by Michael J. Mefford and published in PC Magazine, vol.6, #17 and #21, 
  22. 1987.  I have combined features from these two programs and also added a 
  23. number of new features of my own.  This program is released into the 
  24. public domain, as is, with no warranties of any kind. I will be happy to 
  25. supply source code to any interested party, with the request that if you 
  26. make any significant changes, modifications, or improvements that you 
  27. please share these changes, preferably in source code form, with me and 
  28. the rest of the PC user community. 
  29.  
  30. Usage notes:
  31.    The source and destination directory pathnames are both optional. 
  32. Options, specified by a "/" followed by a letter, may appear either before 
  33. or after the pathnames.  The options are as follows: 
  34.  
  35. /N      Sort directory by filename
  36. /E      Sort directory by extension
  37. /D      Sort directory by date and time
  38. /S      Sort directory by file size
  39. /O      Use original order, i.e. do not sort directory at all. 
  40. /F      Display only filenames, no sub-directories.
  41.  
  42.    DC comes up displaying the "source" or "working" directory.  A brief 
  43. menu of optional commands is displayed to the right of the directory 
  44. dispaly.  You may move up and down the directory list with the up and down 
  45. arrow keys on the cursor keypad.  Files may be individually copied, 
  46. deleted, moved or renamed by pressing the function keys F1 through F4, 
  47. respectively.  Alternatively, a number of files may be selected, or 
  48. "marked" using the grey + and - keys on the right side of the keypad.  
  49. After marking, pressing the appropriated function key will apply the 
  50. chosen operation to the entire group of files. 
  51.  
  52.    Different directories can be displayed in two ways.  One is to press 
  53. the F9 function key and enter a new drive and path name.  Alternatively, 
  54. if you want to move to different sub-directories on the same drive, you 
  55. can simply press the "Enter" key after using the up or down arrow keys to 
  56. high-light the desired subdirectory.  Note that as always within DOS, ".." 
  57. denotes the parent of a given subdirectory, i.e. the level above the 
  58. currently displayed directory. 
  59.  
  60.    Just as pressing Enter lets you view a new directory, pressing Enter 
  61. when a filename is highlighted lets you view the contents of the file.  In 
  62. the default mode the display is wrapped at the edge of the screen if a 
  63. line is more than 80 characters wide.  This option can be toggled by 
  64. pressing W.  Display of non-ascii characters can be toggled with the Ascii 
  65. and Blank options by pressing A or B.  In Ascii mode only strings of 5 or 
  66. more normal ascii characters (including tab or space) are displayed.  This 
  67. is useful for viewing the messages conatained in an .EXE or .COM file.  
  68. With the Blank option, non-ascii characters are replaced with a blank or 
  69. space.  A final option, "*", masks the high-order bit of non-ascii 
  70. characters to make wordstar files readable.
  71.  
  72.  
  73. Key by key summary of commands:
  74.  
  75.    Esc     Exit program and return to original directory.
  76.  
  77.   Alt-Q    Exit program leaving the currently displayed dir as the 
  78.            current default drive and directory for DOS.
  79.  
  80.   Grey +   Mark current file entry, if not a subdirectory or hidden 
  81.            file, and advance cursor to next line.
  82.  
  83.    Grey -  Remove mark on current file, and advance cursor to next line.
  84.  
  85. The following functions operate on the marked files, if any, otherwise
  86. they operate on the currently highlighted file, provided it is not a 
  87. sub-directory entry.  If the operation is successful the mark is 
  88. replaced with an asterix (*), if unsuccessful the file is passed over, 
  89. leaving the mark, and the program proceeds on to the next marked file.
  90.  
  91.     F1      Copy file(s) via a read/write sequence to requested target
  92.  
  93.     F2      Delete file(s) after asking for confirmation.
  94.  
  95.     F3      Move file(s), ie Copy to requested target, delete source.
  96.             Where possible this function is performed using an across 
  97.             directory rename instead of a file read/write sequence.
  98.  
  99.     F4      Rename file(s) or <dir> within the currently displayed directory.
  100.  
  101.     F5      Clear all marks
  102.  
  103.     F6      Mark all remaining files, ie those not marked with an "*".
  104.  
  105.     F7      Swap marked and unmarked files.
  106.  
  107.    The following three functions change the active source and dest 
  108.    directories:
  109.  
  110.     F8      Swap the Working Directory (source) and the Default 
  111.             Destination Directory 
  112.  
  113.     F9      Prompt for a new Working (source) Directory
  114.  
  115.     F10     Prompt for a new Default Destination Directory
  116.  
  117. The directory can be re-sorted by typing:
  118.  
  119.  Alt-N       Sort by filename
  120.  Alt-E       Sort by file extension (eg .COM vs .DOC)
  121.  Alt-D       Sort by date and time
  122.  Alt-S       Sort by file size
  123.  Alt-O       Re-read and display dir in original, unsorted order
  124.  
  125.  Additional commands not appearing in the menu: 
  126.  
  127.  Alt F1      Protected copy - bypass filenamess that already exist on target
  128.  
  129.  Alt R       Re-read working directory.  Required after changing diskettes 
  130.              in a floppy-disk drive. 
  131.  
  132.  
  133.  View Mode commands:
  134.  
  135.  Alt W       Toggle word wrap/horizontal scroll
  136.  Alt A       Toggle Ascii string display
  137.  Alt B       Toggle blanking of non-Ascii characters
  138.    *         Toggle wordstar bit mask (shift non-ascii high-order 
  139.              characters (from 128 to 255) down into the displayable 
  140.              ascii range of 1 to 127. 
  141.  
  142. Revision history:
  143. DC version 1.03  - April 6, 1988
  144.         Add Rename for directories
  145.         Automatically re-read dir with Alt-O original order sort
  146.         More work on error recovery - write protected target
  147.  
  148. DC version 1.02 - March 14, 1988
  149.         Added Alt-F1 "Protected Copy" function.
  150.         Tweaked file view function to save 4 bytes.
  151.         Now highlights last sub-dir viewed when returning to parent dir
  152.  
  153. DC version 1.01 - March 7, 1988
  154.         Modified method of handling directory changes
  155.         F9 (change work dir) now relative to displayed work dir
  156.         Allow specifying both source and dest paths on entry
  157.  
  158. Earlier versions COD1 through COD9: Dec '87 to Mar. '88
  159.         Combined DR and CO, 
  160.         Added ability to change directories
  161.         Added more screen info on bytes free
  162.         Added "spedometer" display of marked files, bytes
  163.         Added "View" options to 
  164.                 toggle word wrap, 
  165.                 Horizontal scroll
  166.                 blanking or full suppression of non-ASCII
  167.  
  168.  
  169. Features that could be added:
  170.  
  171.   Sub-directory functions like RMDIR and MKDIR on directories
  172.   Improved error messages on disk not ready, etc
  173.  
  174.   List options:   hex dump a la Buerg's LIST.COM
  175.                   search/scan for text
  176.                   display current horizontal scroll position
  177.                   improve provisions for re-synch in mode toggles
  178.